Développeurs · Édition du 14 novembre 2026
Créer un outil externe de lecture autorisé
Ce parcours crée un outil Python qui compte les clients autorisés d’une organisation. Il utilise l’API existante, sans modifier le serveur et sans charger de code dans le navigateur. Il ne donne pas accès aux sources privées ni une licence de redistribution. Pour une modification interne, obtenir une copie autorisée du dépôt et suivre les contrôles décrits dans Créer ses propres outils.
Préparer un périmètre de test
- Obtenir l’autorisation de l’administrateur et utiliser une instance fictive, avec un client de test.
- Dans Studio, créer une clé limitée à read:clients. Aucun droit d’écriture n’est nécessaire.
- Définir ORGIA_URL et ORGIA_API_KEY dans l’environnement du processus local ou du serveur de l’intégration. Ne pas incorporer la clé dans ce fichier.
- Créer un dossier de travail séparé et y enregistrer l’exemple sous compter_clients.py. Python et sa bibliothèque standard suffisent.
Écrire l’outil
import json
import os
import urllib.request
import urllib.error
def compter_clients(base, key):
request = urllib.request.Request(
base.rstrip('/') + '/api/v1/clients',
headers={'Authorization': 'Bearer ' + key})
with urllib.request.urlopen(request, timeout=15) as response:
result = json.load(response)
if not isinstance(result.get('data'), list):
raise ValueError('Réponse inattendue : aucun résultat exploitable.')
return {'nombre_clients': len(result['data'])}
if __name__ == '__main__':
try:
result = compter_clients(os.environ['ORGIA_URL'], os.environ['ORGIA_API_KEY'])
print(json.dumps(result))
except urllib.error.HTTPError as error:
print(json.dumps({'erreur_http': error.code}))
raise SystemExit(1)
Lancer python3 compter_clients.py dans l’environnement configuré. Le résultat attendu est un objet nombre_clients égal au nombre des clients fictifs de cette organisation. Aucune clé, liste de coordonnées ou facture ne doit apparaître dans sa sortie. Un code de sortie 1 signale un refus HTTP ; une panne réseau ou une variable absente exige une correction de configuration, pas une clé plus puissante.
Vérifier avant de le brancher ailleurs
- Comparer le compte aux données de l’organisation A.
- Exécuter l’outil avec une autre clé appartenant à B et vérifier le résultat propre à B. La même identité administratrice dans A et membre dans B ne fusionne pas les périmètres des clés.
- Essayer une clé sans read:clients : attendre un refus, pas un résultat vide présenté comme réussi.
- Révoquer la clé de test puis relancer : l’accès doit être refusé.
- Vérifier que le fichier et les journaux ne contiennent aucune clé. Conserver seulement les sorties fictives utiles au contrôle.
Ajouter l’outil à son propre système
Un service contrôlé peut appeler cette fonction et exposer son résultat au système autorisé de l’organisation. Les identifiants restent côté service, hors des prompts et pages publiques. Ce guide ne crée pas de route dans Organisation AI et ne promet pas de chargeur de plugins. Pour donner des écritures à un outil, limiter les droits, prévoir une confirmation humaine et des tests de double exécution avant de demander une nouvelle clé.
Le walkthrough technique d’un exemple ne prouve pas qu’un développeur novice l’a réalisé sans aide. Faire observer ce premier branchement avec un utilisateur représentatif avant de le qualifier d’autonome.